<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>scanu</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="OpcodesTop.html" title="Orchestra Opcodes and Operators" />
    <link rel="prev" href="scantable.html" title="scantable" />
    <link rel="next" href="schedkwhen.html" title="schedkwhen" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">scanu</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="scantable.html">Prev</a> </td>
          <th width="60%" align="center">Orchestra Opcodes and Operators</th>
          <td width="20%" align="right"> <a accesskey="n" href="schedkwhen.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="scanu"></a>
      <div class="titlepage"></div>
      <a id="IndexScanu" class="indexterm"></a>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">scanu</span>
        </h2>
        <p>scanu — 
      Compute the waveform and the wavetable for use in scanned synthesis.
          </p>
      </div>
      <div class="refsect1">
        <a id="idp144149792"></a>
        <h2>Description</h2>
        <p>
      Compute the waveform and the wavetable for use in scanned synthesis.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp144153536"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>scanu</strong></span> init, irate, ifnvel, ifnmass, ifnstif, ifncentr, ifndamp, kmass, \
      kstif, kcentr, kdamp, ileft, iright, kpos, kstrngth, ain, idisp, id</pre>
      </div>
      <div class="refsect1">
        <a id="idp144155712"></a>
        <h2>Initialization</h2>
        <p>
      <span class="emphasis"><em>init</em></span> -- the initial position of the masses.  If this is a negative number, then the absolute of <span class="emphasis"><em>init</em></span> signifies the table to use as a hammer shape.  If <span class="emphasis"><em>init</em></span> &gt; 0, the length of it should be the same as the intended mass number, otherwise it can be anything.
    </p>
        <p>
      <span class="emphasis"><em>ifnvel</em></span> -- the ftable that contains the initial velocity for each mass.  It should have the same size as the intended mass number.
    </p>
        <p>
      <span class="emphasis"><em>ifnmass</em></span> -- ftable that contains the mass of each mass.  It should have the same size as the intended mass number.
    </p>
        <p>
      <span class="emphasis"><em>ifnstif</em></span> -- ftable that contains the spring stiffness of each connection. It should have the same size as the square of the intended mass number.  The data ordering is a row after row dump of the connection matrix of the system.
    </p>
        <p>
      <span class="emphasis"><em>ifncentr</em></span> -- ftable that contains the centering force of each mass. It should have the same size as the intended mass number.
    </p>
        <p>
      <span class="emphasis"><em>ifndamp</em></span> -- the ftable that contains the damping factor of each mass. It should have the same size as the intended mass number.
    </p>
        <p>
      <span class="emphasis"><em>ileft</em></span> -- If <span class="emphasis"><em>init</em></span> &lt; 0, the position of the left hammer (<span class="emphasis"><em>ileft</em></span> = 0 is hit at leftmost, <span class="emphasis"><em>ileft</em></span> = 1 is hit at rightmost).
    </p>
        <p>
      <span class="emphasis"><em>iright</em></span> -- If <span class="emphasis"><em>init</em></span> &lt; 0, the position of the right hammer (<span class="emphasis"><em>iright</em></span> = 0 is hit at leftmost, <span class="emphasis"><em>iright</em></span> = 1 is hit at rightmost).
    </p>
        <p>
      <span class="emphasis"><em>idisp</em></span> -- If 0, no display of the masses is provided.
    </p>
        <p>
      <span class="emphasis"><em>id</em></span> --  If positive, the ID of the opcode.  This will be used to point the scanning opcode to the proper waveform maker.  If this value is negative, the absolute of this value is the wavetable on which to write the waveshape. That wavetable can be used later from an other opcode to generate sound.  The initial contents of this table will be destroyed.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp144235920"></a>
        <h2>Performance</h2>
        <p>
      <span class="emphasis"><em>kmass</em></span> -- scales the masses
    </p>
        <p>
      <span class="emphasis"><em>kstif</em></span> -- scales the spring stiffness
    </p>
        <p>
      <span class="emphasis"><em>kcentr</em></span> -- scales the centering force
    </p>
        <p>
      <span class="emphasis"><em>kdamp</em></span> -- scales the damping
    </p>
        <p>
      <span class="emphasis"><em>kpos</em></span> -- position of an active hammer along the string (<span class="emphasis"><em>kpos</em></span> = 0 is leftmost, <span class="emphasis"><em>kpos</em></span> = 1 is rightmost).  The shape of the hammer is determined by <span class="emphasis"><em>init</em></span> and the power it pushes with is <span class="emphasis"><em>kstrngth</em></span>.
    </p>
        <p>
      <span class="emphasis"><em>kstrngth</em></span> -- power that the active hammer uses
    </p>
        <p>
      <span class="emphasis"><em>ain</em></span> -- audio input that adds to the velocity of the masses. Amplitude should not be too great.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp144244496"></a>
        <h2>Examples</h2>
        <p>
      For an example, see the documentation on <a class="link" href="scans.html" title="scans"><em class="citetitle">scans</em></a>.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp144246704"></a>
        <h2>See Also</h2>
        <p> More information on this opcode: <a class="ulink" href="http://www.csounds.com/stevenyi/scanned/yi_scannedSynthesis.html" target="_top"><em class="citetitle">http://www.csounds.com/stevenyi/scanned/yi_scannedSynthesis.html</em></a>  , written by Steven Yi </p>
      </div>
      <div class="refsect1">
        <a id="idp144248896"></a>
        <h2>Credits</h2>
        <p>
      </p>
        <table border="0" summary="Simple list" class="simplelist">
          <tr>
            <td>Author: Paris Smaragdis</td>
          </tr>
          <tr>
            <td>MIT Media Lab</td>
          </tr>
          <tr>
            <td>Boston, Massachussetts USA</td>
          </tr>
          <tr>
            <td>March 2000</td>
          </tr>
        </table>
        <p>
    </p>
        <p>New in Csound version 4.05</p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="scantable.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="OpcodesTop.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="schedkwhen.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">scantable </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> schedkwhen</td>
        </tr>
      </table>
    </div>
  </body>
</html>
